home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d1
/
cudm31c.arc
/
CUDM31.DOC
< prev
next >
Wrap
Text File
|
1989-09-29
|
63KB
|
1,826 lines
Colorado Utilities
Disk Manager
(CUDM)
Version 3.1
Copyright 1988, 1989
Micro System Solutions
Author: Fred C. Hill
_______
____|__ | (tm)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
This page intentionally left blank
TABLE OF CONTENTS
A NOTE FROM THE AUTHOR. . . . . . . . . . . . . . . . . . . . . . . . . 1
TECHNICAL SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
DISCLAIMER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
ACKNOWLEDGMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
ENHANCEMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
INSTALLING CUDM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
STARTING CUDM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
DEFINING CATALOGS . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CUDM FILES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
CUDM STATUS SCREEN. . . . . . . . . . . . . . . . . . . . . . . . . . . 8
MANAGING THE CATALOG. . . . . . . . . . . . . . . . . . . . . . . . . . 10
CATALOG FEATURE OPTIONS. . . . . . . . . . . . . . . . . . . . . . 10
ADD/UPDATE CATALOG ENTRIES . . . . . . . . . . . . . . . . . . . . 13
LISTING THE CATALOG . . . . . . . . . . . . . . . . . . . . . . . . . . 14
MANIPULATING THE LIST. . . . . . . . . . . . . . . . . . . . . . . 17
CURSOR MOVEMENT . . . . . . . . . . . . . . . . . . . . . . . 18
USING A MOUSE . . . . . . . . . . . . . . . . . . . . . . . . 19
DELETING CATALOG ENTRIES. . . . . . . . . . . . . . . . . . . 19
REMOVE/UNDO REMOVE. . . . . . . . . . . . . . . . . . . . . . 19
ADDING COMMENTS . . . . . . . . . . . . . . . . . . . . . . . 20
COMMENT DISPLAY. . . . . . . . . . . . . . . . . . . . . . . . . . 20
OUTPUT SELECTIONS. . . . . . . . . . . . . . . . . . . . . . . . . 20
PRINT SELECTION . . . . . . . . . . . . . . . . . . . . . . . 20
CONDENSE PRINT. . . . . . . . . . . . . . . . . . . . . . . . 20
DISKETTE COVER. . . . . . . . . . . . . . . . . . . . . . . . 21
LABELS. . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
EXPORT SELECTION. . . . . . . . . . . . . . . . . . . . . . . 21
SYSTEM DEFAULT OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . . 21
COLORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
COLOR WINDOW. . . . . . . . . . . . . . . . . . . . . . . . . 23
BEEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
UPPER/LOWER CASE . . . . . . . . . . . . . . . . . . . . . . . . . 24
SAVE CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . 24
SORTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
UTILITIES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
DOS SHELL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
ERASE CATALOG. . . . . . . . . . . . . . . . . . . . . . . . . . . 25
DISPLAYING DOS DIRECTORIES. . . . . . . . . . . . . . . . . . . . . . . 25
HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
i
A NOTE FROM THE AUTHOR
Please take note of the name change for CUDM. It used to be Diskette
Manager, but as with everything else we change with the times. Most of the
changes reflected in the product have come about because users requested more
and more capability to be built in. CUDM now manages files on both floppy
diskettes and on hard drives. We hope you enjoy the changes.
I have owned microcomputers of one brand or another for the past 6 years,
and during that time have accumulated a great deal of software, including
source code. I also discovered the archive systems from SEA and PKWARE and
used these products to significantly reduce the number of diskettes I needed
to store the thousands of programs, databases, and data and documentation
files. While the archive systems have reduced the cost of storing my
collection of software and data, I have still managed to accumulate about 400
diskettes. The problem now is not "How do I store all this stuff?" but more
like "Now that I have it, how do I find anything?". I wrote CUDM, the
Diskette Manager, to solve that problem.
CUDM will build a master catalog of all diskette and hard disk files, list
them in alphabetical order, and tell me at a glance where my files are
located. CUDM will read libraries and includes the individual files in the
catalog as well as the name of the library from which they came. CUDM will
also identify those files in the master catalog which have identical
filenames (not necessarily duplicates).
When I completed the first pre-release version of CUDM (called DASM in case
you have it) and used it to create my own master catalog I was shocked to
find that almost 30% of my diskette storage was taken up by duplicate files,
duplicate archives, and more than 5 backups of my MS-DOS diskettes. It was
great to be able to erase files instead of searching for diskette space to
store them (which by the way CUDM will enable you to do).
Users of CUDM have available many companion programs which allow the master
catalog and the off-line diskette library to be managed, manipulated, and
controlled as never before. The latest release of CUDM offers users even
more capability, with the registered version allowing you to manage hundreds
of thousands of files.
Fred
1
TECHNICAL SUPPORT
Technical support is available from:
Micro System Solutions (MSS)
5417 S. Cimarron Road
Littleton, CO 80123
Call: 1-(800) 421-1789 or (303) 795-7653
9 AM - 4 PM MST Mon-Fri
The technical support line is available to those who have the registered
version of CUDM. As a registered user, you will be notified when updates to
CUDM or new products are available. You have received the latest version of
CUDM and its documentation. Anyone wishing to offer advice and suggestions
is most welcome to do so. Anyone having access to Compuserve can leave a
message for MSS in either BPROGA or IBMSYS forum. Our Compuserve PPN is
76060,102.
DISCLAIMER
CUDM is provided on an `as is' basis. Any damages arising from the use of
this program are entirely the responsibility of the user. Neither Micro
System Solutions nor the author, Fred C. Hill, can be held responsible for
any damages.
With respect to the physical diskette provided with the registered version,
Micro System Solutions warrants the same to be free of defects in materials
and workmanship for a period of 30 days from the date of purchase. In the
event of notification within the warranty period of defects in material or
workmanship, MSS will replace the defective diskette. Please call to obtain
a return authorization prior to returning your diskette. The remedy for
breach of this warranty shall be limited to replacement and shall not
encompass any other damages, including but not limited to loss of profit,
and special, incidental, consequential, or other similar claims.
Thank you for using CUDM
Ombudsman Policy:
The author, Fred C. Hill is a member of the Association of Shareware
Professionals (ASP). ASP wants to make sure that the shareware principle
works for you. If you are unable to resolve a shareware-related problem with
an ASP member by contacting the member directly, ASP may be able to help.
The ASP Ombudsman can help you resolve a dispute or problem with an ASP
member, but does not provide technical support for members' products.
Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send
a Compuserve message via easyplex to ASP Ombudsman 70007,3536"
2
ACKNOWLEDGMENTS
A great many people have provided input to this version of CUDM and I wish
to pay tribute to them here. First and foremost my wife Elaine for taking
the time to keep me on the right track with all my projects and the patience
to let me try. Borland International for Turbo Pascal. Steve Genusa for
recommending the Turbo Power Professional library which makes up such a large
part of this system. Kim Kokkonen and the people of Turbo Power Software for
such a great and easy to use product. Ed Rauch of Columbia Data Products for
doing so much of the CUDM 'Beta' testing. And all the users whose
suggestions have become an integral part of CUDM.
INTRODUCTION
The Colorado Utilities Disk Manager (CUDM) is designed to allow you to manage
thousands of disk files from both diskettes and your hard disk. It creates
a master catalog of files, libraries, and volumes and allows you to add up
to 60 bytes of comments per entry, if you so desire. CUDM also provides you
with the capability to catalog sub-directories. You can label diskettes as
you catalog them, and you can also print a diskette cover listing volume
contents.
With CUDM you will be able to locate any file on any diskette or hard disk
in seconds. You will be able to find and eliminate duplicate files across
all types of disk storage and manage your free disk space to use fewer
diskettes. CUDM's Catalog Status Screen, visible during most operations,
shows you such important facts as the number of volumes, libraries, and files
in your catalog; how much space has been used and how much space is available
across all your cataloged volumes.
You can update previously cataloged entries or delete entries. You can sort
entries or change the way entries are listed. You can even do string
searches, wild card searches, or `sounds-like' searches to find specific
entries. You can finally get a handle on all those files!
CUDM 3.0 offers three different versions, the difference being the number of
catalog entries that can be recorded and managed. First, any version allows
you an unlimited number of catalogs. However, you can only manage one at a
time, and there is no cross-referencing among catalogs, although conversion
programs are available. CUDM-RM is the Regular Memory version and allows you
to catalog over 4000 files. CUDM-EM is the Expanded Memory version and allows
you to catalog up to 100,000 files per catalog (available in 3rd qtr 1989).
CUDM-VM is the Virtual Memory version which manages up to 300,000 files per
catalog.
You are probably dying to tackle the morass of disks, so let's proceed.
3
ENHANCEMENTS
The following enhancements have been made since CUDM Version 2.2
o Capability to catalog to any level of subdirectory on any type of
drive.
o Full 2 or 3 button mouse support in all windows and menus.
o Length of comments increased to 60 characters from 40.
o Added full-featured DOS Shell.
o Included decompression of .ZIP library files.
o Added imbedded string searches within comments.
o Improved the status screen to show the user the exact real-time
condition of the system as it operates; including available, used
and total capacities of the catalog and memory.
o Updated existing menus and windows to newer, faster window
routines.
o Provided for internal sorting on any of the major data fields
within a catalog entry.
o Added selective remove and unremove of entire volumes, entire
libraries, or individual files from the current catalog.
o Added Soundex searches on any of the name fields.
o Improved input/output speed when reading/writing data files.
o Added the capability to catalog any legal drive A: through Z:.
Although it hasn't been tested on a LAN it should be fully
compatible.
o Allow the user to dynamically change from one master catalog to
another.
o Produce listing, covers and label for all sizes of diskettes.
o Added a context sensitive hypertext help system plus an extended
manual-on-a-disk help system.
4
INSTALLING CUDM
CUDM has three files which must be available in the DOS path while CUDM is
executing. These files are 'CUDM.EXE', and [optionally] CUDM.HLP, and
CUDMCNTX.HLP. If internal help is not required the two 'HLP' files need not
be present.
An installation batch file is provided on the distribution diskette. This
batch file assumes you will be installing from drive A: to drive C: and
creating a subdirectories called \CUDM. If this is not the case please
change the batch file before executing.
Once you have installed the program on your hard disk, you must change your
path command to include the subdirectories CUDM is in or move the CUDM files
to a subdirectory already in the DOS path. An optional procedure for
execution would be to always execute CUDM from its own directory.
5
STARTING CUDM
CUDM is started from the DOS command line by the following:
C>CUDM [catalogfile]
- catalogfile (optional) is the name of the catalog file to
use. If catalogfile is omitted, the system will use the
default catalog name ("CATALOG").
The first time you execute CUDM, you will be prompted to answer the
following:
*******************************
* Catalog does not exist *
* Create [catalogfile]? [Y] *
*******************************
If the catalogfile name is correct and you want to proceed with creating the
catalog, hit <ENTER>, otherwise hit N to abort the start-up.
DEFINING CATALOGS
The Regular Memory (RM) version of CUDM uses all available standard memory
for its catalog files and cannot be modified by the user. The Virtual Memory
(VM) version uses less standard memory, but requires the user to set the
estimated size of the catalogs prior to file creation. CUDM-VM will show you
a screen and allow you to change the three main file capacities as follows:
range: low ........ high default
Volumes: 10 ........ 5,000 500
Libraries: 10 ....... 30,000 1,000
Files: 10 ...... 300,000 10,000
Comment and subdirectory catalog sizes are derived from these three catalog
sizes. Since comments are allowed on any entry in any of the three main
catalogs, sufficient file space is allocated to store comments for all
entries. The subdirectory count estimates the unique subdirectory names
found in the catalog and is calculated at 5 percent of the total number of
file records.
The disk space required for a catalog is roughly equal to the estimated
number of records times 64. Neither of the CUDM versions makes any attempt
to optimize disk usage.
Before cataloging any diskette files, be sure to further define your catalog
feature options discussed under MANAGING THE CATALOG on page 10.
6
CUDM FILES
CUDM.EXE is the main program, while CUDM.OVR is an overlay file. Both are
required for successful CUDM execution. When CUDM creates a master catalog
the following files result:
catalog.DAF - This file stores the files recorded in the master
catalog.
catalog.DAL - This file stores the libraries recorded in the
master catalog.
catalog.DAV - This file stores the volumes recorded in the master
catalog.
catalog.DAC - This file stores the comments recorded in the master
catalog.
catalog.DAD - This file stores the sub-directories recorded in the
master catalog.
CUDM allows you to create as many catalogs as you want. For each catalog
that you create, the five files listed above could result, depending upon the
options you choose for your catalog and the types of files that you record.
CUDM.CFG - This file is created when you change any of the
default printer setting and color settings for CUDM.
catalog.KEP - This file is created when you turn the keep file
subsystem on. It contains the names of the files
and wildcards to include in the current catalog.
7
CUDM STATUS SCREEN
When you start CUDM, you will move to the CUDM Status Screen. This screen
will be visible during many of the operations, since CUDM uses pull-down
menus. The Status Screen is shown below:
Catalog List Options Utilities Directory Help Quit
***************************************************************************
* COLORADO UTILITIES by Micro System Solutions *
*-------------------------------------------------------------------------*
* DISK MANAGER - RM ver 3.1 Copyright 1988,1989 *
***************************************************************************
******* Number of Volumes: 1 Number Files: 20 *******
*------------------------------------------ Space Used: 230,400 *******
******* Directories: 4 | Available: 132,096 *******
******* Comments: 4 | Total: 362,496 *******
*-------------------------------------------------------------------------*
******* Libraries: 4 Number Files: 18 *******
******* Space Used: 20,276 *******
*-------------------------------------------------------------------------*
******* Files: 28 Space Used: 225,906 *******
*-------------------------------------------------------------------------*
******* Available Files: 3864 Libraries: 595 *******
*------------------------------------------ Volumes: 298 *******
******* Memory Available: 381,461 | Total: 4757 *******
*-------------------------------------------------------------------------*
******* Catalog Drive: A: | Master Catalog Name: CATALOG **
***************************************************************************
*************************************************** Last Add Time: 0.0000
The top line of the screen contains the Main Menu selections Catalog, List,
Options, etc. To make your selection, either place the cursor on the Menu
selection and hit <ENTER> or enter the first letter of the item. A short
descriptor appears in the upper left corner and tells you what function is
performed by the menu item on which the cursor is placed. The LIST function
is only accessible AFTER you have cataloged the first diskette. The sections
that follow in the manual will discuss the functions of each of the Main Menu
selections. The Last Add Time is the number of seconds it took to complete
the most recent add/update.
8
The Status Screen shows you the status of the Master Catalog that is listed
in the lower right corner of the screen. Catalog Drive, in the lower left
corner, tells you from which drive CUDM is cataloging. Below, each of the
fields shown on the Status Screen is defined:
NUMBER OF VOLUMES - This is the total number of volumes (diskettes
and hard disk) that you have entered into the
catalog. The next four items relate to the
Number of Volumes and are found to the right
of Number of Volumes on your screen.
Number Files - This is the total number of files contained on
all the volumes. For example, if you cataloged
10 volumes, each containing 10 files, this
value would be 100.
Space Used - This is the total amount of space used across
volumes to store the number of files shown.
Available - This is the total amount of unused or available
space across the volumes shown.
Total - This is the total amount of space accounted for
in the volumes shown.
DIRECTORIES - This shows the number of directories (or sub-
directories) that you have cataloged. If you
do not wish to record directories, you can turn
that feature off (see Managing the Catalog,
page 10) and the Status Screen will reflect a
`disabled' status.
COMMENTS - This shows the number of comments that you have
entered for your catalog entries. If you do
not wish to record comments, you can turn this
feature off (see System Default Options, page
21) and the Status Screen will reflect a
`disabled' status.
LIBRARIES - This is the total number of libraries that you
have entered into the catalog. The next two
items relate to Libraries and are found to the
right of the Libraries heading.
Number Files - This is the total number of files cataloged as
a result of cataloging all the libraries shown.
Space Used - This is the total amount of actual space used
by the library files on their volumes.
FILES - This is the total number of files entered in
your catalog.
Space Used - This is the total amount of space that is or
would be used by the files shown. For library
files that are compressed, this total reflects
the amount of space that those files would use
if they were not compressed.
9
AVAILABLE Files - This is the total number of file entries that
you can add to your catalog.
Libraries - This reflects the number of library entries
that still can be made in your catalog.
Volumes - This reflects the number of volume entries that
still can be made in your catalog.
Total - This is the total number of entries that you
can still make in your catalog.
MEMORY AVAILABLE - This is the total amount of memory still
remaining to accommodate additional catalog
entries.
As you add and manipulate catalog entries, these statistics will change.
MANAGING THE CATALOG
When you select CATALOG from the Main Menu, you will see the following pull-
down menu on your screen:
********************************
* Add/Update *
* *
* Disk Drive A: *
* Catalog Name: CATALOG *
* Expand Libraries - On (Off) *
* Turn Keep Files - On (Off) *
* Keep File List *
* SubDirectories - On (Off) *
* Enable Comments - On (Off) *
* Interface Messages *
*********************************
CATALOG FEATURE OPTIONS
The lower items on the Catalog Menu show you the status of certain catalog
feature options. You can change these features by placing the cursor on the
item and hitting <ENTER>. Below are descriptions of each of the features:
Disk Drive - This identifies the disk drive (floppy or hard)
from which you will be loading your catalog
entries. The options are A: through Z:.
Catalog Name: - This shows the name of your catalog. If you
have multiple catalogs, you can change to
another catalog by hitting <ENTER> on this
item. CUDM will prompt you to enter the name
of the catalog you wish to load. When you have
made an entry, CUDM will save your changes and
then load the new catalog.
10
Expand Libraries - When this feature is ON, CUDM will decompress
any libraries it finds and catalog the
individual files as well as the library. If
the feature is OFF, only the library itself
will be reflected as a file on the volume.
Turn Keep Files - This feature, when ON, will cause CUDM to
compare each of the filenames (including those
from compressed libraries) against the Keep
File List maintained with the next menu item.
Only those files which match will be included
in the current catalog.
Keep File List - This selection will open the keep file list and
allow you to add, change or delete the
filenames or DOS wild cards in the list. A
filename (ex. TPEDIT.PAS) will only allow that
file to be added, while a wild card (ex.
TP*.PAS) will be expanded to 'TP??????.PAS' and
will allow any file with an extension of PAS
that begins with 'TP' to be added. Up to 16
entries may be maintained in the Keep File.
SubDirectories - This feature, when ON, will cause Sub-
Directories to be cataloged and maintained for
files within the catalog. If the feature is
OFF, Sub-Directories will not be cataloged or
referenced.
Enable Comments - This feature, when ON, allows you to enter up
to 60 bytes of comments for any catalog entry.
If the feature is OFF, you can not enter any
comments, nor can you retrieve any previously
entered comments.
Interface Messages - This feature allows you to turn off some of the
prompts encountered while cataloging files.
This will save time and for some is unnecessary
repetition. The selections are discussed
below.
Request Name Chg - When this is YES, you will be prompted with the
Volume Change Name screen, shown on page 13.
Set it to NO by hitting <ENTER>, and CUDM will
bypass the prompt.
Request Disk Load - When this is YES, you will be prompted to enter
a disk in drive A: (or whatever disk drive you
have assigned) for each diskette as described
in ADD/UPDATE CATALOG ENTRIES below. You can
set it to NO by hitting <ENTER>, and you will
not receive the prompt. If you are cataloging
a hard drive this prompt will be suppressed
automatically.
11
Save Each Disk - When this is YES, CUDM, after loading each
disk, will sort the catalog entries and save
the catalog to disk. When you set it to NO,
by hitting <ENTER>, CUDM will not sort and save
the catalog entries until you reset the feature
to YES or complete the catalog function and
move to another function.
You should set these feature options prior to cataloging any files. Some of
these options may be changed from one session to the next, such as the disk
drive, or expand libraries. If you want to use sub-directories, that feature
should be turned ON and remain ON through follow-on sessions. If the feature
is OFF, and your disks contain sub-directories, they will be ignored
(however, the files will be cataloged). When the feature is ON and your
catalog contains sub-directories, when you subsequently turn the feature OFF,
your cataloged sub-directories will not be accessed by CUDM. If you do an
update with sub-directories turned OFF, any sub-directories previously
entered will be lost. The same holds true with comments.
12
ADD/UPDATE CATALOG ENTRIES
After you have set your catalog feature options, you are ready to build your
catalog. To add files to your catalog, place the cursor on Add/Update and
hit <ENTER>. If you are cataloging diskette files, you will be prompted to:
*****************************
* PLACE A DISK IN DRIVE A: *
* *
*****************************
Place the diskette you wish to catalog (or update) into your diskette drive
and hit <ENTER>.
If the volume has not been previously cataloged, the following message will
appear:
*****************************
* Volume is [vol-name] *
* Change Name? [N] *
*****************************
If you do not wish to change the volume label, hit <ENTER> (or N) and the
volume will be cataloged. If you want to change the volume name, key Y and
the following message will appear:
*****************************
* ENTER VOLUME NAME *
* *
*****************************
Key in the volume name and hit <ENTER>.
If your volume does not have a label, you will be asked to enter one.
update it by presenting the following message:
*****************************
* Volume ARC_0001 exists *
* *
* Update? [N] *
*****************************
If you do NOT want to update, press <Enter>. Otherwise type in Y and CUDM
will add or change catalog information to reflect the current contents of the
volume. Files and libraries that have been removed from the disk since it
was cataloged or last updated will be removed from the catalog as well. If
you have previously entered comments for any entry, the comments will be
maintained after the update as long as the file/library continues to exist
on the disk.
When you have finished cataloging your disk files, you can then view them by
accessing the LIST Menu. You can move to the LIST Menu by hitting <Esc> to
return to the Main Menu and then selecting LIST. Alternatively, you can go
to the LIST Menu from the CATALOG Menu by pressing <ALT-L>.
13
LISTING THE CATALOG
The LIST functions allow you to review and manipulate the catalog entries.
The full catalog list provides the following information for each file:
o Volume
o Library.Ext
o Filename.Ext
o Size
o Date (Last Updated)
o Time (Last Updated)
When the above information is showing on the screen, CUDM places a "+" to the
right of the catalog entry to indicate that a comment is present. If you
have enabled comments, they will appear on the screen in the rightmost 40 -
60 characters of the catalog entry and will overlay the Size, Date, and Time
information. When the comment exceeds the available screen characters, the
information will scroll to the left, showing up to 40 characters. We will
discuss how to enter comments and manipulate catalog entries later.
In addition to the above information, CUDM will list a "d" to the right of
any file record that is a duplicate file name. You can change the
information presented in the List by selecting the Parameters Option from the
LIST Menu (discussed below).
When you select LIST, the following Menu will appear:
**************************
* Entries *
* Duplicates *
* Volume Information *
* Imbedded Search *
* Soundex *
* Wild Card *
* Parameters *
**************************
The Menu Options are discussed below:
Entries - This allows you to select the catalog list for
Files, Libraries, or Volumes. A Sub-Menu will
be presented for you to make your list choice.
Duplicates - This allows you to list duplicate Files or
Libraries. A Sub-Menu will be presented for
you to make your list choice.
14
Volume Information - This allows you to list the volumes in your
catalog. When you make this selection, CUDM
provides you with a list of the volume names
in the catalog. Select the volume you wish to
view and CUDM will give you the following
information about the volume: Volume Name,
Date Created, Capacity, Space Used, Freespace,
Number of Files, and any Comment associated
with the volume. You will also be given a list
of all the libraries and files contained on the
volume.
Imbedded Search - This allows you to search the Files, Libraries,
or Volumes entries for a specific string of
characters. After you select your entry type,
you will be prompted to enter the scan mask.
CUDM will search the entry names for the
string.
Soundex - This allows you to search the Files, Libraries,
or Volumes entries for any name that "sounds
like" a name that you enter. After you select
your entry type, you will be prompted to enter
the scan mask. CUDM will search the entry
names for anything that equals or sounds like
the scan mask. The search is done against the
ENTIRE entry name - it does not do a partial
name search.
Wild Card - This allows you to use the DOS wild card search
technique against the Files, Libraries, or
Volumes. After you select your entry type, you
will be prompted to enter a scan mask, e.g.,
*.BAS or FILEABC.*. CUDM will search the entry
names and return any matches.
Parameters - This allows you to control the information that
is presented on the list. When you select
Parameters, you will be given the Sub-Menu
shown below.
Parameters Menu:
**************************
* File/ext Split - On *
* Print Comments No *
* List Library Yes *
* Volume Yes *
* Size Yes *
* Time Yes *
* Comment No *
* Directory No *
**************************
15
The parameter options are as follows:
File/ext Split - When this feature is ON, file and library names
will be aligned on the period. For example,
given two filenames, TEXT.EXT and TESTFILE.EXT
- when the split feature is ON, the filenames
would list as:
TEXT .EXT
TESTFILE.EXT
If the feature is OFF, they would list as:
TEXT.EXT
TESTFILE.EXT
Print Comments - When this feature is ON, comments will print
when a Print Selection is made. Comments will
print beneath the entry for which they have
been made. When the feature is OFF, the
comments will not print.
List Library - Setting any of these features ON will cause
Volume that particular column to be displayed on the
Size list. If the feature is OFF, the column will
Time not show on the listing.
List Comment - Setting this feature ON will cause the comments
to be displayed in the rightmost 40 characters
of an entry on the screen. The comment will
replace the Size and Time columns. You will
notice that when you turn Comment ON, Size and
Time automatically are set to OFF. When the
List Comment feature is OFF, comments will not
automatically show on the listing. You can,
however, use the "Show Comment" feature
discussed under Manipulating the List (see
below). This feature will not function if
Comments are disabled (see Managing the
Catalog, page 10).
List Directory - Setting this feature ON will cause the Sub-
directory Name to be listed on the bottom line
of the screen. The name will change as you
move the cursor to a new entry. When the
feature is OFF, the sub-directory name will not
be displayed. This feature will not function
if Directories are disabled (see Managing the
Catalog, page 10).
16
MANIPULATING THE LIST
When you have selected your entries and defined the information for your
list, you are then ready to manage the list or the catalog. It is during
this stage that you will add comments, identify duplicates, erase files from
the catalog, and plan for reorganizing and optimizing your disk storage. A
number of options are available for you to manipulate the list to accomplish
your goals. When you are in a List, you can press F9 to get the following
List Sub-Menu:
*******************************
* Hide (Show) Comments *
* Remove (Undo Remove) Entry *
* *
* Print Selection *
* Compressed List *
* Diskette Cover *
* Labels *
* Export Selection *
*******************************
Each of these menu items is discussed under its appropriate operation on the
following pages. If the cursor will not highlight a particular option, that
option is not applicable to the List currently displayed. For example,
Diskette Cover and Labels are only appropriate when listing Volumes. When
you are listing Files, you cannot select either of those options.
18
CURSOR MOVEMENT
When you are presented with a listing, whether it be one of volumes,
archives, files, or a DOS directory, you may move about the list using the
various cursor control keys on your keyboard. They work as follows:
Up Arrow - Moves the cursor (or highlighted line) up one line.
If the cursor is already at the top of the screen
then entries will be scrolled down one line. (until
the first entry is displayed on the first line).
Down Arrow - Moves the cursor (or highlighted line) down one
line. If the cursor is already at the bottom of the
screen then entries will be scrolled up one line.
(until the last entry is displayed on the last
line).
Page Up - Scrolls the displayed entries up one page of data.
On a standard mono or CGA screen this would be 18
lines. On an EGA screen it would be 37 lines. Of
course the total data movement will depend on the
number of data entries in the catalog.
Page Down - Scrolls the displayed entries down one page of data.
This operation is the exact opposite of the page up
command.
Home - Returns the screen to the home or first page of
data.
End - Displays the last page of data. This assumes there
is more than one page of data to be displayed.
Ctrl-PgUp - This key combination operates exactly like the Home
key.
Ctrl-PgDn - This key combination operates exactly like the End
key.
Esc - The <Esc> key will always cancel the current
operation and in most case back you out of the
operation. Once you reach the inactive screen the
<Esc> key will return you to the main menu and back
to the inactive screen.
19
USING A MOUSE
You can also use a mouse with CUDM. If you have a mouse connected to your
system, you will notice the mouse cursor on your screen. To use the mouse,
place the cursor on the menu item that you want to select and press the left
button. If you want to escape the menu, press the right button. If you want
to access the Help window for the particular function, press both buttons.
When you are in a list window, you can scroll through the list, forward or
backward, by placing the cursor on the scroll bar to the right of your screen
and pressing the left button. If you place the cursor at the top of the
line, you will move to the top entry in the list. If you place the cursor
in the middle of the line, you will move to a middle entry in the list. If
you place the cursor at the bottom of the line, you will move to the last
entry in the list, and so on. A scroll box will remain on the line to mark
the place you last selected.
DELETING CATALOG ENTRIES
To delete an entry from the catalog (list), place the cursor on the entry and
press the F5 function key. You will notice that the entry line changes color
(or shading if you have a monochrome monitor). When you move the cursor off
the deleted entry, the color will change again, so that you can always see
the deleted entries. If you wish to undo the delete, simply repeat the
operation just described. The selected entries will actually be deleted when
you exit the LIST session. If you delete a volume or library, the files on
that volume or library are also deleted. You can also delete/undelete an
entry using the Remove Entry/Undo Remove.
REMOVE/UNDO REMOVE
As mentioned above, you can delete an entry by placing the cursor bar on the
entry, pressing F9, and selecting Remove Entry from the Menu shown on page
17. When you press <ENTER>, the entry will change in color or shading to let
you know that the entry is to be deleted. If you wish to reverse your
action, press F9 again and the menu will offer you the option to Undo Remove.
When you press <ENTER>, the entry will remain in the catalog.
If you remove a library or volume, the files that make up that library or
volume will also be removed. If you undo a remove on a library or volume,
all of the comprising files will be also be restored to the catalog. Even if
you undo a remove for a single file on a removed volume, all files on the
volume will be restored.
20
ADDING COMMENTS
If you have Enabled Comments (see Managing the Catalog, page 10), you can
enter a comment for any or all entries. To enter the comment, hit <ENTER>
or function key F7, and you will see the comment area highlighted. Key in
your comment (up to 60 characters) and hit <ENTER>. If your comment is
longer than the 40 characters on the screen, the comment will scroll to the
left, allowing you to continue entering characters to the right. If the
comment field is not showing on your screen, you will see a "+" to the right
of each entry which has a comment associated with it. You can view the
contents of any comment by hitting <ENTER> or F7. To turn the comment off,
just hit <ENTER> or F7 again.
COMMENT DISPLAY
The default mode for the display of comments is to HIDE them. When the list
is in the HIDE mode, you can look at an single entry's comment by placing the
cursor bar on that entry and hitting <ENTER>. Hitting <ENTER> again will
turn the comment off. If you wish to see the comments for the entire list,
press F9 and the menu will offer you the option to SHOW comments. When
comments are showing, the menu will offer you the option to HIDE the
comments.
OUTPUT SELECTIONS
You can print a given list of entries or you can write an ASCII file to the
default drive. To set the system default options for your printer select
Options from the Main Menu (see System Default Options, page 21). To execute
an output function, press F9 to get the List Menu shown on page 17.
PRINT SELECTION
Place the cursor on Print Selection and hit <ENTER>. This option will give
you a normal print of all of the entries for which you have selected the
list,.e.g., Files, Volumes, or Libraries. If comments are to be printed,
they will print beneath the entry to which they apply.
CONDENSE PRINT
When you select Condense Print, CUDM will print two entries per line when
comments are not printed. When comments are to be printed, it will print an
entry with its comment on the same line. Both lists use the condensed print
feature of your Epson-compatible printer.
20
DISKETTE COVER
This selection is applicable only to a Volume List. It allows you to print
a diskette cover that lists all files on the volume. The diskette cover will
fit inside the sleeve of a 5 1/4" diskette.
LABELS
This selection is applicable only to a Volume List. It allows you to print
the names of files contained on the volume to one or more one-up labels. The
first label contains the volume name, the number of DOS files on the volume
(not the expanded file count), the available space on the volume, and up to
40 file names. Any additional labels will contain up to 70 file names.
Information is printed using the condensed print feature of your Epson-
compatible printer. The following menu is provided to select from:
*************************
* 1.5" X 4" *
* 5.25" 1.5" X 4.75" *
* 3.5" 2.75" X 2.75" *
* Enhance Header - No *
*************************
4 X 1.5" - This label is the most common size available for
5.25" diskettes.
5.25" 4.75 X 1.5" This is the new Avery label (#4240) designed for
5.25" diskettes.
3.5" 2.75" X 2.75" This is the Avery label (#4241) designed for 3.5"
diskettes.
Enhance Header If the feature is turned ON, the Volume and Catalog
Name will be printed full size while the remainder
of the label will be extremely small. Only 35
filenames will be placed on the first label.
EXPORT SELECTION
When you choose the Export Selection, CUDM writes the current entry list in
ASCII format to the drive and directory from which you are executing.
SYSTEM DEFAULT OPTIONS
The System Default Options, selected from the Main Menu (Options) allow you
to:
o change the colors used on any of the CUDM screens,
o set a beep to occur when menus appear and disappear,
o set upper and lower case letter sensitivity,
o establish sort sequences for your catalog lists,
o save your printer and color settings for follow-on sessions.
21
When you select Options, you will get the following Options Menu:
************************************
* Colors *
* Beep - Off *
* Upper/Lower Case (Upper Case) *
* Save Configuration *
* File Sort *
* Library Sort *
* Volume Sort *
************************************
COLORS
This feature allows you to change the colors that CUDM uses for its menus and
windows. When you select Colors, you will get the following Color Menu:
*******************************
* Main Menu *
* Status Window *
* Alert Window *
* Request Window *
* List Window *
* List Submenu *
* Directory Window *
* Color Menu *
* Help Window *
* Set Default Colors *
* Set Monochrome *
*******************************
This is a list of all the different menus and windows used by CUDM. The Main
Menu and the Status Window shown on page 8. The Alert Window appears when
CUDM is saving your changes. The Request Window prompts you to enter data.
The windows shown under ADD/UPDATE CATALOG ENTRIES (page 13) are Request
Windows. The List Window is the actual catalog entry listing. The List Sub-
Menu is shown on page 17. The Directory Window results when you display a
DOS directory, as discussed on page 25. The Color Window is shown above.
The Help Window shows the help instructions discussed on page 25. Set
Default Colors allows you to reset the colors to the original CUDM settings,
and Set Monochrome allows you to adjust settings for monochrome monitors.
Since each window or menu is different, each may have a different subset of
components for which you can change the color. Each of the possible
components is described below.
Frame - This is the outline surrounding a menu or window.
Header - This is the title or heading found at the top of a
menu or window.
Body - This is the remainder of the window or menu,
including the background and the text.
Statistics - These are the statistics or numbers that appear and
change on the Status Window. The headers that
define the statistics are considered part of the
Body.
22
Selected Text - This is the line of text on which the cursor is
resting. It includes the text and the background.
Hilight - Each selectable menu item will have one letter that
is highlighted (often the first letter). That
letter can be entered to select the item in lieu of
placing the cursor on the item.
Help - This is the descriptor that appears in the upper
left corner of the Status Screen.
Disabled - This is any menu item that you cannot select because
it is not applicable to the operation at hand.
Shadow - This is a background shadow used to emphasize a help
window.
Deleted Entry - This is found on the List Menus and is an entry that
you have deleted from a catalog list. This entry
is not selected by the cursor.
Selctd-Deleted - This is found on the List Menus and is an entry that
you have deleted from a catalog list and the cursor
is resting on the specific entry.
When you select the List Window from the Color Menu shown above, you will
then be given the List Menu, as shown on page 14 (less Parameters). You must
then choose which type of List Window you wish to change. Then, as with all
other Color Menu choices, you will be given the Color Window.
COLOR WINDOW
The Color Window will appear on the screen to the left of the Color Menu and
reflects the color scheme for the particular menu or window that you have
chosen. For example, if the body of the chosen menu is black letters on a
gray background with a red frame, the Color Window will show the word "Body"
in black on a gray color strip. The word "Frame" would be in red on a gray
color strip. The default color selection in the Main Menu for Selected Text
is yellow letters on blue background.
The Color Window shows all the components of the particular window or menu
that can be changed. To change the background color strip, press the PgUp
or PgDn key. To change the color of the component, press the Home or End
key. When you have completed your color selections, hit <ENTER>. Then call
up the window or menu to see how it looks.
Several of the windows and menus include the Help component, which is the
descriptor in the upper left corner of the Status Screen. The Status Screen
is visible when many of the windows or the menus are on the screen. However,
if you set the Help component of another window or menu to colors other than
those set for the Status Screen, the Help Component will change when you
initiate that particular window or menu.
23
BEEP
When this feature is ON, your computer will beep when pull-down menus/windows
appear and disappear. When the feature is OFF, all is quiet.
UPPER/LOWER CASE
This feature allows you to specify whether or not you want CUDM to be
sensitive to upper and lower case letters. If the setting is Upper/Lower
Case, CUDM will be sensitive to and show upper and lower case letters when
used in volume, library, and file names. If the setting is Upper Case, all
names will be shown in upper case letters.
SAVE CONFIGURATION
This allows you to save any color changes that you make. If you are using
the CUDM default color selections, you will not be able to select this item.
When you change those colors, you must select this item if you want them
saved for subsequent sessions.
SORTS
You can establish the main sort field for each of the catalog lists - File,
Library, and Volume. Select the type list for which you want to set the sort
order (the default is the entry name). You will be given a menu which lists
the fields that show on the particular list. The fields may include the
Volume Name, Library/Ext, Filename, Extension, Size, and Date. Place the
cursor on the field that you want the list to be sorted on and press <ENTER>.
The list will then be sorted in ascending order on that field.
UTILITIES
When you select Utilities, you are given the following options:
***************************
* DOS Shell *
* Erase Catalog *
***************************
DOS SHELL
This allows you to make a temporary exit to DOS while CUDM is executing.
Simply place the cursor on DOS Shell and press ENTER. To return to CUDM from
DOS, enter EXIT.
24
ERASE CATALOG
This allows you to erase the entire contents of your master catalog. The
catalog name will remain intact. If you want to erase all reference to the
catalog, you must exit CUDM and use the DOS ERASE command to erase all files
related to catalogfile (the name that you assigned to the catalog).
DISPLAYING DOS DIRECTORIES
This allows you to view your DOS directories while running CUDM. To
accomplish this, select Directory from the Main Menu. You will then be
prompted to:
***************************
* Enter a filename mask *
* *
***************************
If you press <ENTER> without entering a mask, you will get a directory
listing for the drive and directory on which you are executing. You can
place the cursor on any listed <dir>, and CUDM will then show you a listing
of that directory. If you wish, you can enter the name of a specific
directory (e.g., \pathname), or you can enter a wild card parameter (e.g.,
*.da?).
HELP
The CUDM system has two help systems builtin. The one accessed from the main
menu is called the extended help system and is essentially this document
converted to an indexed disk file. The second is a context-sensitive help
system which is accessed by using the <F1> key from anywhere in the system.
It will provide you with a brief tutorial of options available to you at that
point in time. The context-sensitive help system is not designed to replace
this documentation but to provide a quick interactive memory jog.
QUIT
This menu option does just what it says. It terminates the program and
returns to DOS.
Thank you for using Colorado Utilities Disk Manager.
25
NOTES
26
NOTES
27